Skip to content

feat(patient): autoavaliação local no pilar A, sem sessão nem registro no servidor (C-11, #132) - #161

Merged
hbgit merged 4 commits into
developfrom
feat/issue-132-autoavaliacao-local
Nov 14, 2026
Merged

hbgit merged 4 commits into
developfrom
feat/issue-132-autoavaliacao-local

Conversation

@vinimartinsufrr

Copy link
Copy Markdown
Collaborator

Closes #132

PR empilhado sobre o #160 (C-04). A base é feat/issue-127-pedido-de-contato-192, então o diff mostra só a C-11. Quando o #160 for mesclado, esta base passa a ser develop. Motivo: o vermelho da autoavaliação local precisa da orientação "Ligar 192" da C-04. Sem ela, o resultado local mostraria a promessa antiga "Sua equipe de saúde foi avisada", sem nada ter sido enviado.

C-11 (RF04, RF16, RF22, RNF09): no pilar A a autoavaliação roda no aparelho, sem accessToken e sem gravar em triage_sessions. A chamada remota fica só no pilar B, com sessão.

O que muda

  • Motor no aparelho. SelfAssessmentEngine em apps/patient/lib/core/triage/self_assessment.dart é a mesma árvore do TriageEngine.
    • É Dart puro, sem nenhum import: o teste de paridade o carrega na VM do backend.
    • O resultado é traduzido para RiskLevel por nome, nunca por índice.
  • Entrada sem conta. A tela de entrada ganhou Autoavaliação (sem cadastro), no mesmo padrão do botão da biblioteca da C-03 (Feat/c 03 biblioteca educativa #156).
    • O botão abre TriageScreen(local: true), que nunca lê o BackendScope.
    • Nada é enviado e as respostas não são gravadas.
  • Resultado local honesto. O texto diz que nada foi enviado ao agente nem ao servidor, e o botão vira "Concluir", no lugar de "Acompanhar solicitação".
    • O vermelho abre a orientação "Ligar 192" e grava o evento local (C-04).
  • Com sessão (pilar B), nada muda: triage.evaluate.
  • Backend sem mudança de código: só o teste novo.

Paridade no CI (terceiro critério)

  • O teste. backend/sinalacs_server/test/unit/self_assessment_parity_test.dart importa o motor do app por caminho relativo e o compara com o TriageEngine nas 64 combinações.
    • A comparação é pelo nome do nível.
    • O teste também exige que as três saídas apareçam: dois motores que sempre devolvessem o mesmo nível também seriam "iguais".
  • Onde roda. No dart test do job serverpod-backend, que é check obrigatório, em todo PR, qualquer que seja o motor alterado. O ci.yml não tem filtro de caminho, e o ci_invariants.sh impede que ganhe um.
  • Mutação conferida. Tirar bleeding do vermelho no motor do app reprova o teste na combinação 16.
  • Mover o arquivo do app quebra a compilação do teste: ele não pode se desligar em silêncio.
  • Lint. O avoid_relative_lib_imports do import ficou com ignore justificado. O dart analyze do backend continua com as mesmas 98 infos da develop, nenhuma nova.

Critérios de aceite

  • Sem login, a autoavaliação produz o mesmo resultado que o motor do backend para as 64 combinações (paridade acima, e a tela usa esse motor).
  • Nenhuma chamada de rede na autoavaliação do pilar A. test/local_self_assessment_test.dart usa um backend que registra qualquer método chamado; forçar o modo remoto na tela reprova 4 dos 5 testes.
  • O teste de paridade roda no CI a cada mudança em qualquer um dos dois motores.

Como testar

cd apps/patient && flutter analyze && flutter test        # 355 testes
cd backend/sinalacs_server && dart test test/unit/self_assessment_parity_test.dart test/unit/triage_engine_test.dart

Docs

  • AGENTS.md e apps/CLAUDE.md: os dois diziam que o app não pode ter regra de risco no cliente. Agora registram a exceção da C-11 e a regra de mudar os dois motores no mesmo PR, subindo selfAssessmentEngineVersion.
  • Demais: spec/requisitos_piloto.md (RF04), spec/lgpd_design.md §0, docs/telas-paciente.md e PROGRESS.md.

Fora deste PR

… combinações (#132)

SelfAssessmentEngine é a mesma árvore do TriageEngine, em Dart puro sem
import. O teste de paridade do backend importa o arquivo do app e compara os
dois motores nas 64 combinações em todo PR (job serverpod-backend).
…132)

Botão na tela de entrada abre TriageScreen(local: true): sem accessToken, sem
triage.evaluate e sem gravar respostas. O resultado diz que nada foi enviado;
o vermelho abre a orientação "Ligar 192". Com sessão, nada muda.
/// A tradução para [RiskLevel] é por **nome**, nunca por índice.
RiskLevel _evaluateOnDevice() {
final level = const SelfAssessmentEngine().evaluate(
chestPain: _answers[TriageSymptom.chestPain] ?? false,

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pedido. A paridade prova que o motor do aparelho é igual ao do backend, mas nada prova que a tela entrega a resposta certa a cada parâmetro. Conferi por mutação: trocando esta linha por chestPain: _answers[TriageSymptom.difficultyBreathing] ?? false,, a pessoa que responde só "dor no peito" recebe verde no modo local, e test/local_self_assessment_test.dart continua 5/5 verde. A amostra do teste 4 cobre só febre, vômitos e nenhum sinal; dor no peito, falta de ar e fraqueza nunca são respondidos sozinhos.

Como a INV-02 agora depende também desta ligação, peço um teste que responda cada sinal sozinho (mais "nenhum"; hoje faltam dor no peito, falta de ar e fraqueza, que nenhum teste responde isolados) e compare a saída da tela com SelfAssessmentEngine — o vermelho aparece como call_192_title, amarelo e verde como o rótulo do cartão. São sete execuções curtas e pegam qualquer resposta perdida ou trocada de classe. Se quiser ir além, as 64 combinações com o motor como oráculo também cabem num testWidgets.

Comment thread PROGRESS.md

- **O que mudou.** A tela de entrada ganhou **Autoavaliação (sem cadastro)** (`LocalSelfAssessmentScreen`), que roda a árvore no aparelho por `SelfAssessmentEngine` (`apps/patient/lib/core/triage/self_assessment.dart`, Dart puro sem import): sem `accessToken`, sem rede, sem `triage_sessions`, sem gravar as respostas. O resultado local diz que nada foi enviado e troca "Acompanhar solicitação" por "Concluir"; o vermelho abre a orientação "Ligar 192" e grava o evento local (C-04). Com sessão (pilar B), nada muda: `triage.evaluate`. Backend sem mudança.
- **Paridade (INV-02 com dois motores).** `backend/sinalacs_server/test/unit/self_assessment_parity_test.dart` importa o motor do app por caminho relativo e o compara com o `TriageEngine` nas 64 combinações, por nome do nível, e exige que as três saídas apareçam. Roda no `dart test` do job `serverpod-backend` (check obrigatório) em **todo** PR — o workflow não tem filtro de caminho, garantido por `ci_invariants.sh` —, seja qual for o motor alterado. Mutação conferida: tirar `bleeding` do vermelho do app reprova na combinação 16. Mover o arquivo do app quebra a compilação do teste, em vez de desligá-lo em silêncio.
- **Provas.** Paciente: `flutter analyze` sem avisos, 355 testes. `test/local_self_assessment_test.dart` (5) usa um backend que registra **qualquer** método chamado: nenhum na autoavaliação local; forçar o modo remoto na tela reprova 4 dos 5. Backend: `dart analyze` sem issue nova; o teste de paridade e o `triage_engine_test.dart` verdes.

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pedido. O CONTRIBUTING.md pede para não gravar contagens de testes nos documentos ("elas envelhecem a cada PR"). Sugiro tirar "355 testes", "(5)" e "4 dos 5" desta linha e deixar as contagens só no corpo da PR, por exemplo:

  • Provas. Paciente: flutter analyze sem avisos novos e suíte verde. test/local_self_assessment_test.dart usa um backend que registra qualquer método chamado: nenhum na autoavaliação local; forçar o modo remoto na tela reprova o teste. Backend: dart analyze sem issue nova; o teste de paridade e o triage_engine_test.dart verdes.

// alcance daqui sem trazer o Flutter para o backend. O caminho relativo é o
// ponto do teste.
// ignore: avoid_relative_lib_imports
import '../../../../apps/patient/lib/core/triage/self_assessment.dart' as app;

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Registro. Aprovo o import relativo: é o que permite ao job serverpod-backend compilar o motor do app sem trazer Flutter para o backend, e o comentário acima justifica o ignore. Conferi as duas pontas por mutação: tirar bleeding do vermelho no app reprova na combinação 16, e tirar persistentVomiting do amarelo no backend reprova na combinação 8. Fica registrado que mover ou renomear apps/patient/lib/core/triage/self_assessment.dart quebra a compilação deste teste — é o comportamento desejado, e quem mover o arquivo atualiza este caminho no mesmo PR.


// As três saídas aparecem: uma árvore que devolvesse sempre o mesmo nível
// nos dois lados também seria "igual".
expect(seen, {'red', 'yellow', 'green'});

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sugestão. A paridade não pode pegar uma mudança feita igual nos dois motores (é para isso que ela existe), e é justamente nesse caso que selfAssessmentEngineVersion tem de subir — senão o evento local "Ligar 192" passa a dizer arvore-v1 para uma regra que não é a v1. Uma forma barata de prender a versão, sem versão no backend: guardar a tabela das 64 saídas por versão e exigir que a versão corrente bata.

// Cada versão publicada da árvore e as 64 saídas dela (máscara 0..63; r/y/g).
const _arvores = {
  'arvore-v1': 'grrryrrryrrryrrr' 'rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr',
};

test('a versão do motor corresponde à árvore em vigor', () {
  final saidas = [
    for (var mask = 0; mask < 64; mask++)
      const TriageEngine().evaluate(/* mesmos seis bits do laço acima */).name[0],
  ].join();
  expect(_arvores[app.selfAssessmentEngineVersion], saidas,
      reason: 'a árvore mudou: suba selfAssessmentEngineVersion e acrescente a linha nova');
});

Mudou a árvore sem subir a versão, o teste reprova; a troca da tabela fica visível no diff para quem revisa.

),
const SizedBox(height: 8),
Text(
'Classificação feita pelo protocolo da equipe de saúde.',

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sugestão. No modo local esta frase continua aparecendo: "Classificação feita pelo protocolo da equipe de saúde." No pilar A não há equipe nem sessão, o projeto não tem vínculo com unidade de saúde, e o RF04 do piloto pede "nunca 'classificação de risco'". Como esta PR já troca a frase de orientação quando local é true, sugiro esconder esta também no modo local (ou trocar por algo como "Orientação educativa, calculada neste aparelho."). O texto final das saídas é da C-08 (#130); se preferir deixar para lá, basta citar esta frase na #130.

@hbgit hbgit left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Revisei a PR contra a issue #132, a INV-02 (determinismo da triagem, mesma entrada → mesmo resultado, nunca alterável) e a regra do escopo (pilar A sem conta e sem rede, RNF07/RNF09). Os três critérios de aceite estão atendidos:

Critério da #132 Evidência
Sem login, o resultado é o mesmo do motor do backend nas 64 combinações backend/sinalacs_server/test/unit/self_assessment_parity_test.dart: laço mask 0..63, comparação por name (não por índice) e expect(seen, {'red','yellow','green'}) — dois motores constantes não passam. O segundo teste prende que os nomes de SelfAssessmentLevel e RiskLevel são os mesmos, o que protege o RiskLevel.values.byName da tela. A tela usa esse motor (_evaluateOnDevice, apps/patient/lib/app/app.dart:1632).
Nenhuma chamada de rede no pilar A apps/patient/test/local_self_assessment_test.dart: _NetworkSentinel registra qualquer método de PatientBackend por noSuchMethod e lança; testes 1 e 3 afirmam a lista inalterada. PatientBackend é o único caminho de rede do app (grep por HttpClient/http/WebSocket/mqtt em apps/patient/lib: nada).
A paridade roda no CI a cada mudança de qualquer motor .github/workflows/ci.yml:121: dart test sem filtro em backend/sinalacs_server, job serverpod-backend (check obrigatório), sem filtro de caminho (garantido por ci_invariants.sh).

O que rodei em Linux (worktree limpo da branch, 15fd57b):

  • Mutação 1, motor do app: tirar bleeding do vermelho em self_assessment.dart → dart test test/unit/self_assessment_parity_test.dart reprova (exit 1) na combinação 16, Expected: 'red' / Actual: 'green'. Revertido com git checkout --.
  • Mutação 2, motor do backend: tirar persistentVomiting do amarelo em triage_engine.dart → reprova na combinação 8. Revertido. A paridade pega mudança dos dois lados.
  • Mutação 3, ligação da tela: em _evaluateOnDevice, passar a resposta de falta de ar no lugar da de dor no peito → flutter test test/local_self_assessment_test.dart passa (5/5). Revertido. Ver Inline 1.
  • dart test test/unit/self_assessment_parity_test.dart test/unit/triage_engine_test.dart: +11: All tests passed!.
  • dart analyze no backend: 98 issues, nenhuma nos arquivos da PR (o ignore: avoid_relative_lib_imports funciona).
  • Paciente: flutter analyze só com o aviso asset_directory_does_not_exist de assets/certs/ (diretório gitignorado, não é da PR); flutter test completo: +355: All tests passed!.
  • bash scripts/qa/check_documentation_links.sh: só o graphify-out ausente em AGENTS.md, gitignorado, já assim antes.

Pontos que conferi e aprovo:

  • self_assessment.dart é Dart puro, sem nenhum import (só library;), com a árvore idêntica à do TriageEngine linha a linha; o comentário explica por que não pode importar nada.
  • No modo local, o único BackendScope.of do _TriageScreenState fica no ramo false do ternário; Call192OrientationScreen também não lê o BackendScope (só Call192Scope). Nada no modo local depende de servidor.
  • Resultado local: o texto diz que nada foi enviado e o botão é "Concluir" (teste 2 afirma também a ausência de "solicitação" e "entrará em contato"); o vermelho abre a orientação "Ligar 192" da C-04, grava call192OrientationShown com selfAssessmentEngineVersion e recomeça do passo 1 sem guardar as respostas (teste 3).
  • INV-02 na tela: nenhum caminho altera o resultado — _risk só é escrito com a saída do motor, não há campo editável, e o vermelho nunca vira cartão.
  • O ignore: avoid_relative_lib_imports está justificado em comentário, e mover o arquivo do app quebra a compilação do teste (o job fica vermelho, não verde em silêncio).
  • AGENTS.md e apps/CLAUDE.md registram a exceção à regra "sem regra de risco no cliente" e a obrigação de mudar os dois motores no mesmo PR com selfAssessmentEngineVersion novo. spec/lgpd_design.md corrige a frase que dizia que a autoavaliação era enviada ao servidor.
  • Pilar B inalterado: o teste 5 prova que, com sessão, a triagem continua indo a triage.evaluate.

Pedidos (nesta PR): teste da ligação respostas → motor (Inline 1); contagens fora do PROGRESS.md (Inline 2).

Sugestões (opcionais): prender selfAssessmentEngineVersion à tabela das 64 saídas (Inline 4); frase "Classificação feita pelo protocolo da equipe de saúde" no modo local (Inline 5); dois comentários de app.dart que ficaram desatualizados (Geral).

Registros: import relativo aprovado (Inline 3); o botão novo e os testes 2 e 5 precisam de ajuste quando a #156 e a #157 entrarem (Geral).

@hbgit

hbgit commented Nov 13, 2026

Copy link
Copy Markdown
Owner

comentários desatualizados e convivência com a #156 e a #157

Comentários em app.dart fora do diff (sugestão). Dois comentários perto da tela ficaram desatualizados com a C-11 e podem enganar quem mexer na tela depois:

  • app.dart:1554-1556, no enum TriageSymptom: diz que calcular risco no cliente era "duas regras de risco no mesmo produto, o que viola o determinismo exigido pelo PRD (INV-02)". Agora existem dois motores por desenho, com paridade provada; vale citar a exceção e o teste de paridade.
  • app.dart:1579-1581, em _risk: "Risco devolvido pelo servidor" e "Não existe cálculo de risco neste arquivo". No modo local o risco vem do aparelho. A segunda frase continua verdadeira (o cálculo está em self_assessment.dart), mas vale dizer de onde vem _risk em cada modo.

Convivência com a #156 e a #157 (registro, para quem fizer o rebase). O botão "Autoavaliação (sem cadastro)" entra no mesmo bloco da tela de entrada em que a #156 acrescenta "Biblioteca de saúde (sem cadastro)" (login_library_button), e a #157 reescreve essa tela (convite QR + PIN): o bloco if (_step == _LoginStep.credenciais) ...[...] deixa de existir e vira _camposDoConvite() (sem credencial no aparelho) ou _camposDoPin() (com credencial). Para o botão sobreviver às duas:

Base automatically changed from feat/issue-127-pedido-de-contato-192 to develop November 13, 2026 14:53
app.dart: botão de autoavaliação ao lado do botão da biblioteca (C-03)
no bloco de credenciais. PROGRESS.md: mantém as seções novas.
@hbgit
hbgit merged commit 667f478 into develop Nov 14, 2026
25 of 28 checks passed
@hbgit
hbgit deleted the feat/issue-132-autoavaliacao-local branch November 14, 2026 00:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants